Inside Macintosh: QuickTime Components /

Chapter 8 - Video Digitizer Components / Video Digitizer Components Reference

Video Digitizer Component Functions / Setting Video Destinations

VDSetPlayThruGlobalRect

You can use the VDSetPlayThruGlobalRect function in your application to establish the destination settings for a video digitizer component that is to digitize into a global rectangle. The application provides the desired settings as parameters to this function. Not all video digitizer components support global rectangles.

pascal VideoDigitizerError VDSetPlayThruGlobalRect
                               (VideoDigitizerComponent ci,
                                 GrafPtr theWindow, 
                                 Rect *globalRect);

ci

Specifies the video digitizer component for the request. Applications obtain this reference from the Component Manager's OpenComponent function.

theWindow

Contains a pointer to the destination window.

globalRect

Contains a pointer to a rectangle that specifies the size and location of the video destination. This rectangle must be in the coordinate system of the destination window specified by the theWindow parameter.

DESCRIPTION

Applications should verify that the digitizer component can accommodate the settings by calling the VDPreflightGlobalRect function, described in the next section.

RESULT CODES

noErr	0	No error
digiUnimpErr	-2201	Function not supported

SEE ALSO

Applications set the source digitizer rectangle by calling the VDSetDigitizerRect function, described on page 8-29.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help